home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmeTransferAddDoneProc.z
/
XmeTransferAddDoneProc
Wrap
Text File
|
1998-10-30
|
11KB
|
199 lines
XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc - A toolkit function that establishes
a procedure to be called when data transfer is complete
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/TransferP.h>
vvvvooooiiiidddd XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(
XXXXttttPPPPooooiiiinnnntttteeeerrrr ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd,
XXXXmmmmSSSSeeeelllleeeeccccttttiiiioooonnnnFFFFiiiinnnniiiisssshhhheeeeddddPPPPrrrroooocccc ddddoooonnnneeee____pppprrrroooocccc);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc establishes a procedure to be called
by the toolkit when a data transfer operation is complete.
This routine can be called from an
XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedure or from any function called
as a result, including the following:
+o From the selection procedures called as a result of
calls to _X_m_T_r_a_n_s_f_e_r_V_a_l_u_e,
+o From a ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnPPPPrrrroooocccc trait method; ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnPPPPrrrroooocccc
is one of the trait methods of the _X_m_Q_T_t_r_a_n_s_f_e_r trait.
If more than one such procedure has been established for a
given transfer operation, all procedures are called when the
transfer operation is complete.
The _d_o_n_e__p_r_o_c argument holds a function of type
XXXXmmmmSSSSeeeelllleeeeccccttttiiiioooonnnnFFFFiiiinnnniiiisssshhhheeeeddddPPPPrrrroooocccc, which has the following definition:
vvvvooooiiiidddd ((((**** XXXXmmmmSSSSeeeelllleeeeccccttttiiiioooonnnnFFFFiiiinnnniiiisssshhhheeeeddddPPPPrrrroooocccc))))(
WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
XXXXttttEEEEnnnnuuuummmm ooooppppeeeerrrraaaattttiiiioooonnnn,
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt ****ccccaaaallllllll____ddddaaaattttaaaa);
_w_i_d_g_e_t Specifies the widget that requested the
conversion.
_o_p_e_r_a_t_i_o_n Specifies the transfer operation. Possible values
are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmLLLLIIIINNNNKKKK, and XXXXmmmmOOOOTTTTHHHHEEEERRRR.
_c_a_l_l__d_a_t_a Specifies a pointer to an
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt structure containing
information about the status of the transfer.
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt is defined as follows:
typedef struct {
int _r_e_a_s_o_n;
Page 1 (printed 10/24/98)
XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc((((3333XXXX))))
XEvent *_e_v_e_n_t;
Atom _s_e_l_e_c_t_i_o_n;
XtPointer _t_r_a_n_s_f_e_r__i_d;
XmTransferStatus _s_t_a_t_u_s;
XtPointer _c_l_i_e_n_t__d_a_t_a;
} XmTransferDoneCallbackStruct;
_r_e_a_s_o_n Indicates why the callback was invoked.
_e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback.
It can be _N_U_L_L.
_s_e_l_e_c_t_i_o_n Indicates the selection being converted.
_t_r_a_n_s_f_e_r__i_d
Specifies a unique indentifier for the data
transfer operation.
_s_t_a_t_u_s Indicates whether or not the transfer completed
successfully. Following are the possible values:
XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____DDDDOOOONNNNEEEE____SSSSUUUUCCCCCCCCEEEEEEEEDDDD
The transfer completed successfully.
XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____DDDDOOOONNNNEEEE____FFFFAAAAIIIILLLL
The transfer did not complete
successfully.
_c_l_i_e_n_t__d_a_t_a
Specifies data to be passed to the callback
procedure.
The XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc routine takes the following
arguments:
_t_r_a_n_s_f_e_r__i_d
Specifies a unique indentifier for the data
transfer operation. The value must be the same as
the value of the _t_r_a_n_s_f_e_r__i_d member of the
XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedure or the
ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnPPPPrrrroooocccc_X_m_Q_T_t_r_a_n_s_f_e_r trait method.
_d_o_n_e__p_r_o_c Specifies a procedure to be called when the data
transfer is complete. The procedure is of type
XXXXmmmmSSSSeeeelllleeeeccccttttiiiioooonnnnFFFFiiiinnnniiiisssshhhheeeeddddPPPPrrrroooocccc.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3),
Page 2 (printed 10/24/98)
XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc((((3333XXXX))))
XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3),
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3), and XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3).
Page 3 (printed 10/24/98)